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►YOUR GAME 


Getting started with ink in your own game 
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Window 


Close Window 


Message Box 


Confirmation Dialog 


Set Text Box 


Get Text Box 


Set Label 


SetTextField 


Get Textfield 


Set ProgressBar 


Variables 


Right (Text) 

Default = THAT'S RIGHT! 


HigherMsg (Text) 

Defat = Hf 3 r er 


LowerMsg (Text) 

Default = Lower 


Two (Number) 

Default = 2 


One (Number) 

Default = 1 


First (Number) 
; ■ =i 


High (Number) 

Defaut = 100 


Low (Number) 

Default = 0 
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Debut = 0 


Guesses (Number) 

Default = 0 
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What is an interactive story? Well, you're 
reading one! 


Except of course, this isn't really a story. This is 
a tutorial. In most interactive stories, you - the 
reader - would be telling the story what you 
want the main character to do, by making 
choices. 


But for now, we’re trying to learn how it works. 
So let's get going. 



















2 links. 







Okay 


I still don't get it. An example, please? 
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Tutorial in progress. 


contents 


write 


read 


Contents 


The beginning i end 


Introduction 


^ Interactive what? 

What is an interactive story? Well, you're reading one! 


Except of course, this isn't really a story. This is a 
tutorial. In most interactive stories, you - the reader - 
would be telling the story what you want the main 
character to do, by making choices. 

But for now, we're trying to learn how it works. So let’s 
get going. 

2 links. 


Oh, okay. Here goes. Urn... 

► Example story 

© 

Choose a tutorial 

© 

► Sharing stories 

© 

► Changing the flow ; end 

Q 

► Options 1 end 

Q 

The Contents List 

© 






sign into save “', 7 ; 


Map - Section 1 


The king was thought to have died, and 
the queen, believing it, died of grief. 


The king arranged with his Court 
Physician to pretend that he had died, 
and left the castle. The queen, believing 
he was gone, died of grief. 


The king disappeared from the kingdom 
because he was kidnapped by an evil 
wizard. Then the queen died of grief. 


The king arranged with his Court 
Physician to protend he had died. He left 
a note for the Queen with the physician. 


The king arranged with his Court 
Physician to pretend that he had died, in 
order to decora his wife the queen, from 


Section 1 

The king died and then the queen died of 
grief. 


The king died, and so the queen decided 
to fake her own death. 



The king died. Since the queen had been 
paras itically feeding upon him throughout 
his life, when he died she was deprived 
of sustenance, and wasted away as well. 

End. 


The king died, and so the queen decided 
to fake her own death so that she could 
leave the kingdom. 

End. 


The king died. The queen was 
suspicious that someone had killed him, 
so she faked her own death. 


"N 


The king disappeared from the kingdom 
because he was kidnapped by an evil 
wizard. Everyone thought he might be 


ooo 


The king died. The queen was 
suspicious that someone had killed him. 
Fearing that the murderer wished to Kill 


The king died. The queen was 
suspicious that someone had killed him. 
Wishing to investigate the murder, she 


◄ ► 
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INK: BASICS 

== pari 98 == 

= intro 

~ learn_name_of_cantopani_innkeeper = true 
'I'm a hungry traveller and need to eat.' 

He motions you on ahead. 'You'll find the inn in the centre 
of the village. It's run by Amelia. There isn't much there, but 
you'll get something for your belly.' 

* [Thank him] -> thank 

* [Shove him aside] -> shove 

= thank 

'I thank you,' you reply, with a slight bow. He bows in 
reply, but the movement looks awkward on him, like he was a 
performing bear. -> par81 

= shove 

You shove him carelessly aside and he falls into the mud. 

-> par81 
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'I’m a hungry traveller and need to cat.' 

He motions you on ahead. 'You'll find the inn in 
the centre of the village. It's run by Amelia. There 
isn't much there, but you'll get something for your 
brllv.' 
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Tm a hungry traveller and need to cat.' 

He motions you on ahead. 'You'll find the inn in 

J 

the centre of the village. It's run by Amelia. There 
isn't much there, but you'll get something for your 
belly.' 
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'I thank you,' you reply, with a slight bow. He 
in reply, but the movement looks awkward on 
like he was a performing bear. 
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INK: INLINE LOGIC 


CYCLES: You {&chew through munch on} the moss. 


You chew through the moss. 

o 


You munch on the moss, 


You chew through the moss. 
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INK: INLINE LOGIC 

CONDITIONALS: It is much like the last bunch you 

{eatit:ate|{tasteit: tasted|did not dare to taste }. 


Has visited 

= eatit 

? 

• 

-► 

It is much like the last bunch you ate. 

' 1 , 1 

Has visited 

= tasteit 

? 

• 


It is much like the last bunch you tasted. 
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Has visited neither? 

-► 

It is much like the last bunch 

you did not dare to taste. " 


INK: THE NARRATIVE SCRIPTING LANGUAGE BEHIND 80 DAYS AND SORCERY! 


@inkleStudios @joethephish 


INK: APPROACHING PROCEDURAL NARRATIVE 


{&Laying your pack down | {&{&Setting Putting down |{&Removing Unstrapping ] your pack 
{on_the_ground(}}, you try to {&settle j stretch out rest despite the {drenched: shivering 
cold of your still-wet clothing |{&cold {landscape == TREES: unsettling noises in the trees 
wind strange noises that float across the landscape}}. 

Laying your pack down by the cliff-edge, you try to settle 

despite the cold wind. 



Putting down your pack by the roots of a tree, 
you try to stretch out despite the shivering cold of 

your still-wet clothing. 
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INK: WEAVE 


== pari 98 == 

~ learn_name_of_cantopani_innkeeper = true 

'I'm a hungry traveller and need to eat.' 

He motions you on ahead. 'You'll find the inn in the centre 
of the village. It's run by Amelia. There isn't much there, but 
you'll get something for your belly.' 

* 'I thank you[.'],' you reply, with a slight bow. He 
bows in reply, but the movement looks awkward on him, like he 
was a performing bear. 

* [Shove him aside] You shove him carelessly aside and he 
falls into the mud. 


- -> par81 
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INK: WEAVE 



Choice (1 & 2): C I thank you.’ 


‘I thank you,’ you reply. 


Game output (1 &3): 
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== bangalore == 

- We spent most of our time in Bangalore Cantonment 
rather than the City proper, as it was administered 
directly by the Raj. 

I had a few hours spare, so 

* I was happy to pretend I was still in Europe[] if I 
could, (lower(style)} 

* ... I stayed indoorsE] with Monsieur Fogg, tending 
to his needs, while we plotted our departure with haste. 

-> DONE 

* ... I took a walk in Meade's Park[], where a group 
of off-duty cavalry officers were playing a game of 
cricket under the shade of peepul trees. 

- "Fancy playing with us?" a young chap with a sparse, 
optimistic moustache called out. 

* "I don't play cricket. "[] I told him 

^ ^ • • • ruefullyE] . 

** . . .with a shrug[] . 

— "/Don't play cricket?/" He looked utterly 


aghast. "My dear fellow, my dear fellow. How can this 
be?" 

Clearly, he was of that particular mould of 
Englishman who ordered their life around the cricket- 
lawn and the fox hunt. 

** "No interest, reallyE."]," I replied. 

"No... /interest/?" He repeated my words 
to himself several times, as if that would somehow 
alter their meaning. He squinted at me as though he 
were an Artificer, and I a particularly troublesome 
automaton. "You are quite serious?" 

”1 do not care for sport." 
"Association football is more my 

style. " 

— He looked quite ill at my statement. 
"You Continentals,” he said in an odd, strangled 
tone. "You're even stranger than the natives; at 
least /they/ like a cricket match, same as any 
Englishman . " 

-> end_bangalore 

** "I have always wanted to learnE.”]," I 

replied. 

A smile leapt to his face. "Then today is 
your chance!" He handed me the red-leather cricket 
ball. 
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INK: WEAVE 


"Well, Poitou? Suicide or... murder?” 

* "Suicide!" 

"Really, Poitou? Are you quite sure?" 

* * "Quite sure." 

* * "It is perfectly obvious.” 

* "Murder!" 

"And who did it?" 

* * "Detective-Inspector Jape!" 

* * "Captain Hasty!" 

* * "Myself!” 

- - "You must be joking!" 

* * "Mon ami, I am deadly serious." 

* * "If only. . . " 

- Mrs. Christine lowered her manuscript a moment. 
The rest of the writing group sat, open-mouthed. 


IN GAME: 


"Well, Poitou? Suicide or... murder?" 
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INK: WEAVE 


"Well, Poitou? Suicide or... murder?” 

* "Suicide!” 

"Really, Poitou? Are you quite sure?" 

* * "Quite sure." 

* * "It is perfectly obvious.” 

* "Murder!" 

"And who did it?" 

* * "Detective-Inspector Jape!" 

* * "Captain Hasty!" 

* * "Myself!" 

- - "You must be joking!" 

* * "Mon ami, I am deadly serious." 

* * "If only. . . " 

- Mrs. Christine lowered her manuscript a moment. 
The rest of the writing group sat, open-mouthed. 


IN GAME: 


"Murder!" 


"And who did it?" 

"Detective-Inspector Jape!" 
"Captain Hasty!" 

"Myself!" 
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INK: WEAVE 


"Well, Poitou? Suicide or... murder?” 

* "Suicide!" 

"Really, Poitou? Are you quite sure?" 

* * "Quite sure.” 

* * "It is perfectly obvious.” 

* "Murder!" 

"And who did it?” 

* * "Detective-Inspector Jape!" 

* * "Captain Hasty!" 

* * "Myself!" 

- - "You must be joking!" 

* * "Mon ami, I am deadly serious." 

* * "If only. . . " 

- Mrs. Christine lowered her manuscript a moment. 
The rest of the writing group sat, open-mouthed. 


IN GAME: 


"Murder!" 

"Detective-Inspector Jape!" 


"You must be joking!" 

"Mon ami, I am deadly serious." 
"If only..." 
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INK: WEAVE 


* 


* 



"Well, Poitou? Suicide or... murder?” 

"Suicide!" 

"Really, Poitou? Are you quite sure?” 

* * "Quite sure.” 

* * "It is perfectly obvious.” 

"Murder ! " 

"And who did it?” 

* * "Detective-Inspector Jape!" 

* * "Captain Hasty!" 

* * "Myself!" 

- - "You must be joking!" 

* * "Mon ami, I am deadly serious." 

* * "If only. . . " 

Mrs. Christine lowered her manuscript a moment. 
The rest of the writing group sat, open-mouthed. 


IN GAME: 


"Murder!" 


"Detective-Inspector Jape!" 


"If only..." 


Mrs. Christine lowered her manuscript a 
moment. The rest of the writing group sat, 
open-mouthed. 
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WEAVE: DECLARATIVE FORWARD FLOW 

► Emphasis on content, not flow 

► Great for dialog 

► A "sub-format" of ink 
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MOTIVATIONS FOR INK 2 


► More maintainable 

► Future proof 

► Weirdly, I like compilers :-) 

► Open source? 
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THE PIPELINE 




INK FILE 



INK 


COMPILER 



80 DAYS AND SORCERY! 


@inkleStudios @joethephish 


JSON 

FILE 
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INK 2 - “HELLO WORLD" EXAMPLE 


Hello world. 
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INK: MIXED WEAVE SYNTAX 


What's your favourite colour? 

* Blue[], I thought to myself. -> but 

* [Red] -> red 

= red 

Red, I thought angrily. 

-> but 

= but 

But there was no time to answer. 
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COUNTER-INTUITIVE QUIRKS OF INK 

► More markup than programming language 

► We embrace GOTO 

► Punctuation heavy (!?) :-) 
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THE SMALL FOOTPRINT 


using Ink. Runtime; 

// 1) Load story 

Story story = new Story . CreateWithJson(sourceJsonString) ; 

// 2) Game content, line by line 

while(story . canContinue) 

Console. WriteL ine (story . Conti nue()) ; 

// 3) Player makes a choice 

Console. WriteLine(story . currentChoices[0] . choiceText) ; 
story . ChooseChoiceIndex(0) ; 


// 4) Back to 2 
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HOW WE DO DIALOG (WE DON’T) 

Anna (shocked): You said WHAT?! #closeup 
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INK 2: ADVANCED STRUCTURING 


TUNNELS: -> sleep -> dream -> wake -> 


THREADS: <- desert_interactions 


<- anna conversation 
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INK: DIFFICULTIES AND DOWNSIDES 

LOCALISATION & AUDIO? 

THE PROBLEMS: 

► Quantity 

► Word-by-word variability 
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INK: DIFFICULTIES AND DOWNSIDES 


Original ink: 


Minimum versions, 
full variability 


Translated versions 


Automatically 

re-encode? 

(is this even possible 
without errors?) 


“ Hello Hi there , 



“Hello, world” 
“Bon jour, le monde” 



“ Bonjour Salut , 


world everybody ” 



“Hi there, everybody” 


“Salut, tout le monde” 



tout le monde” 
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INK: DIFFICULTIES AND DOWNSIDES 


CAN YOU HELP? 
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INK IS OPEN SOURCE! 

www.github.com/inkle/ink 

My email address: 
ioe@inklestudios.com 




